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***Redistribution and use in source and binary forms, with or 
without modification, are permitted provided that the following 
conditions are met: 

* Redistributions of source code must retain the above 
copyright notice, this list of conditions and the following 
disclaimer. 

* Redistributions in binary form must reproduce the above 
copyright notice, this list of conditions and the following 
disclaimer in the documentation and/or other materials 
provided with the distribution. 

* The end-user documentation included with the 
redistribution, if any, must include the following 
acknowledgment: 

"This product includes software developed by the 
Apache Software Foundation (http://www.apache.org/)." 
Alternately, this acknowledgment may appear in the 
software itself, if and wherever such third-party 
acknowledgments normally appear. 

* The names "Apache" and "Apache Software Foundation" 
must not be used to endorse or promote products 
derived from this software without prior written 
permission. For written permission, please contact 
apache@apache.org. 

* Products derived from this software may not be called 
"Apache", nor may "Apache" appear in their name, 
without prior written permission of the Apache Software 
Foundation. 

THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED 
OR I MPLI ED WARRANTI ES, I NCLUDI NG, BUT NOT LI MITED TO, 
THE IMPLIED WARRANTIES OF MERCHANTABI LITY AND 



FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN 
NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR 
ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT INDIRECT 
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 
DAMAGES (INCLUDING, BUT NOT LI Ml TED TO, PROCUREMENT 
OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, 
OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 
CAUSED AND ON ANY THEORY OF LIABI LITY, WHETHER I N 
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
NEGLI GENCE OR OTHERWI SE) ARI SI NG I N ANY WAY OUT OF 
THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
POSSIBILITY OF SUCH DAMAGE.*** 



**** Permission to use, copy, modify, distribute and sell this 
software and its documentation for any purpose is hereby 
granted without fee, provided that the above copyright notice 
appear in all copies and that both that copyright notice and this 
permission notice appear in supporting documentation. Dr. 
John Maddock makes no representations about the suitability 
of this software for any purpose. It is provided "as is" without 
express or implied warranty.**** 



*****Permission is hereby granted, free of charge, to any 
person obtaining a copy of this software and associated 
documentation files (the "Software"), to deal in the Software 
without restriction, including without limitation the rights to 
use, copy, modify, merge, publish, distribute, and/or sell copies 
of the Software, and to permit persons to whom the Software 
is furnished to do so, provided that the above copyright 
notice(s) and this permission notice appear in all copies of the 
Software and that both the above copyright notice(s) and this 
permission notice appear in supporting documentation. 

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY 
OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT 
LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
FITNESS FOR A PARTICULAR PURPOSE AND 
NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT 
SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN 
THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL 
INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES 
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR 
PROFITS, WHETHER IN AN ACTION OF CONTRACT, 



NEGLI GENCE OR OTHER TORTI OUS ACTI ON, ARI SI NG OUT OF 
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF 
THIS SOFTWARE. 

Except as contained in this notice, the name of a copyright 
holder shall not be used in advertising or otherwise to promote 
the sale, use or other dealings in this Software without prior 
written authorization of the copyright holder.***** 



****** Redistribution and use in source and binary forms, with 
or without modification, are permitted provided that the 
following conditions are met: 

* Redistributions of source code must retain the above 
copyright notice, this list of conditions and the following 
disclaimer. 

* Redistributions in binary form must reproduce the above 
copyright notice, this list of conditions and the following 
disclaimer in the documentation and/or other materials 
provided with the distribution. 

* Neither the name of I ndustrial Light & Magic nor the 
names of its contributors may be used to endorse or 
promote products derived from this software without 
specific prior written permission. 

THIS SOFTWARE IS PROVIDED BY THE COPYRI GHT HOLDERS 
AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED 
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABI LITY AND FITNESS 
FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT 
SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE 
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 
NOT LI MITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR 
TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.***** 
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Alienbrain Studio 8.0 Release Notes 



Release Notes for Alienbrain 8.0 



There are significant upgrades and changes between Alienbrain 
Version 8.0 and previous versions. Please read this document 
thoroughly and should you have any questions with regards to items in 
it, then please contact one of our local Application Engineers. 

It is very important that administrators also read the document 
entitled "Changes You Need to Know About Starting in Version 8" on 
page 20 to find out administration-specific information and installation 
procedure changes for version 8. 

I f you are upgrading to Alienbrain 8.0, you need to get a new 
license key prior to installation. You cannot complete the upgrade 
installation without an updated license key. To request your permanent 
key, please e-mail the Hardware ID displayed in the Licenses view of 
the Administration Client to licensing@alienbrain.com, and specify 
what type/how many licenses you need. See "Upgrading Alienbrain to 
Version 8.0" for details on the available clients and the client mapping 
for 8.0. 

The alienbrain.xml file which configures the preview server is 
overwritten at the time of upgrade because of significant changes to 
the preview server. The old file is backed up to alienbrain.xml BAK 

Please compare the two files and merge any necessary changes into 
the new alienbrain.xml file. In the new file, the 
ServerEnableDiskGuard setting is now "no" and the 
ServerCacheDiskTimeout setting is "200days". Previously only files 
older than 10 years were deleted, and in the new version, deleting old 
files is disabled (if enabled, the default is 200 days). Files are only 
deleted when disk space runs out (this is unchanged). Additionally the 
current file now has defaults of ServerCacheMemoryTimeout="2hours" 
(previously 12 hours) and ServerCacheGuardRescanDelay="lhours" 
(previously 1 day). 



Where to Find Help 
Documentation 



Guides for Alienbrain 8.0 are available as PDFs and as Online Help 
under: 

• Start> Programs> Alienbrain> Documentation 

• C:\ Program Files\ alienbrain\ Documentation on the 

client 
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• C:\Program Files\ alienbrain\ WebRoot\ Documenta- 
tion I nstallation Guide on the server machine 

Alienbrain Wiki and FAQ 

Replacing the former Alienbrain forum, we now offer an Alienbrain Wiki 
which features a comprehensive FAQ section: 

http://alienbrain.wiki.avid.com/ 
You'll find an abundance of information in these pages. 
For additional inquiries, do not hesitate to contact Alienbrain support at 

support@alienbrain.com 
(The Alienbrain forum remains available for customers on a valid 
maintenance contract.) 



Supported Platforms and Integrations 



Supported Client 
Platforms 



Supported Server 
Platforms 



Supported 
I ntegrations 



Alienbrain 8.0 client is supported to run on these operating systems: 

• Windows NT 4 Workstation, NT 4 Server 

• Windows 2000 Professional, Server, Advanced Server, 
Datacenter Edition 

• Windows XP Home, Windows XP Professional (SP 2 or later) 

• Windows Vista 

• Windows Server 2003, Standard Edition, Enterprise Edition, 
Datacenter Edition 

• Linux/i386 

• Mac OS X 10.2, 10.3, 10.4 

Alienbrain 8.0 server is supported to run on these operating systems: 

• Windows NT 4 Server 

• Windows 2000 Server, Advanced Server, 
Datacenter Edition (SP 4 or later) 

• Windows Server 2003, Standard Edition, Enterprise Edition, 
Datacenter Edition (SP 1 or later) 

Alienbrain 8.0 integrations include the following third party 
applications: 

• Autodesk Maya: 7.0, 8.0, 8.5 

• Autodesk 3dsMax: 8.0, 9.0 

• Autodesk AliasStudio: 12.0, 13.0 

• Softimage XSI: 5.0, 5.1, 6.0 

• Adobe Photoshop: 7.0, 8.0 (CS), 9.0 (CS2) 
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• Microsoft Visual Studio: 2003, 2005 
The MS Office Integration has been dropped. 



I mportant I retaliation and Update Notes 

Windows Vista • I nstallation - 

Compatibility Sometimes the Alienbrain installer needs to re-boot and con- 

tinue the installation. When prompted, confirm the continua- 
tion so that the installation can be properly completed. 

• Icons in list - 

Under some circumstances the icons (thumbnail view) may 
display a bit distorted. 

Windows User Rights We recommend that you run your Alienbrain Client application on at 

least Windows PowerUser rights. With rights less than PowerUser 
rights Windows does not allow Alienbrain to write or modify files in the 
Alienbrain installation folder. 

So running an Alienbrain Client with e.g. standard User rights the 
following doesn't work: 

• I nstallation of Alienbrain 

• Update/Customization installation using the package installer 

• Generation and update of log files and error reports 

• Your customizations might want to have write access as well 

• Generally all operations that try to write into the Alienbrain 
installation folder. 



Licensing If you want to upgrade an Alienbrain 7.x version to Alienbrain 8, you 

need to request a new license key first. If you are upgrading an 
Alienbrain 6.x version to Alienbrain 8, please contact Alienbrain 
support. 

Database Location (The following paragraph does not apply to you if you are running 

Alienbrain 7.5.2 and newer. If you are running Alienbrain 7.5.1 or older 
please read ahead.) 

The Alienbrain database (meta data information, Database folder) 
MUST reside on the Alienbrain server machine. However, until 
Alienbrain 7.5.1, the server did not enforce this and could load 
databases located on a remote network share. This could lead to 
database inconsistencies and database corruption. 
Starting with Alienbrain 7.5.2, and still in 8.0, the server will not load 
remote databases anymore. 

We STRONGLY recommend using the tool SplitSetupCheck.exe (found 
on the CD in folder \Tools\NXNSplitSetupCheck) to verify your 
configuration BEFORE upgrading a 7.5.1 server to 8.0. It generates a 
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Health Monitor Jour- 
nal Thread Warning: 



report and point out projects causing problems. If you encounter 
reported errors, please refer to the following description and 
document: 

http://alienbrain.wiki.avid.com/index.php/ 

FAQ: Administration: ServerAdmin: DbAndAssetsStorage: 1. 

(The following paragraph does not apply to you if you are running 
Alienbrain 7.5.2 and newer. If you are running Alienbrain 7.5.1 or older 
please read ahead.) 

During backup and under rare circumstances, the Health Monitor may 
report that the journal thread is unresponsive or not operating. If you 
experienced this behaviour in 7.5.0 or 7.5.1 and got the hotfix from 
support, it is IMPORTANT that you delete the following key in the 
registry: 

HKEYLOCALMACHI NE\SOFTWARE\NxN\alienbrain\DatabaseServer\ 
HealthMonitor. 



Project Converter 
in 8.0 



File Folder Branching 



(The following paragraph does not apply to you if you are running 
Alienbrain 7.5.2 and newer. If you are running Alienbrain 7.5.1 or older 
please read ahead.) 

Users who converted projects from 6.0 to 7.x and still want to use 
these projects in 8.0 must run the new command tool 
(ProjectConverterRun2.exe) provided with 8.0. This new converter 
fixes the following issues: 

• Bucketing aborts when assets in different folders in the tree 
have the same name 

• Preview unavailable for assets converted from 6.0 to 7.5.1 
Use the following procedure: 

1. Shut down the server and make a backup (asset & database). See 
the Alienbrain Administration Guide for the database (Metadata) 
backup process. 

2. Run the following commands: 
ProjectConverterRun2.exe rollback -s 
"\\SERVER\\SHARE\Project_file.pro" 
ProjectConverterRun2.exe convert -s 
"\\ S E RVE R\\ S HARE\ Proj ectf i le . p ro" 

NOTE: Users converting from 6.x to 8.0 should follow the instructions 
above, however we HIGHLY recommend to run the conversion on a 
test system first. Before applying changes to the live system, please 
send the ProjectConverterRun2 logfile along with the Database 
consistency check log to support@alienbrain.com for approval. 

In past releases (up to 7.1.x), users were able to create file folder 
branches using the option available in the File and Folder Branching 
tab (Branching Manager Utility). 
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However, this utility was making it unnecessarily hard for branching 
managers to maintain branches when more than one file/folder were 
added to this branch, or if the unique added folder was not the root 
folder of the base branch. 

Therefore, since 7.5.0, this type of branch creation was not possible 
anymore, and the tab "File and Folder Branching" option was removed. 
For already existing branches, this tab was still displayed but actions 
were limited to branch name or type edits. 

7.5.2, 8.0 and later releases do not allow the sub-branch creation 
based on existing file folder branches. However, if this file folder 
branch contains a unique folder which corresponds to the root folder of 
its base branch, sub-branch creation remains possible. 



Changes and Enhancements to the Alienbrain Administration 

Bucketing The bucket feature in the Administration Client has been re-designed 

in order provide a specific view instead of the Bucketing wizard. This 
offers a more robust and powerful user interface as well as a faster 
search for bucketable items on the server. New search criteria and the 
use of user defined configuration sets (templates) have also been 
introduced. 

CLS provides a way to manage licenses centrally across several 
Alienbrain servers (in case of load distribition among several Alienbrain 
servers for example). Each project server will forward license requests 
to the CLS. From now on, every new user connecting to a project (from 
any machine) will lock one of the available licenses. This license 
belongs exclusively to this particular user until it is explicitly released 
by the administrator (e.g., if the user does not connect to projects 
anymore). If the CLS is unavailable or unreachable, projects servers 
will fall back to their local license cache, thus enabling already licensed 
users to connect to projects. New users can not aquire licenses while 
the CLS is unavailable. The local license cache expires after 
approximately 7 days. 

Grouped Projects A group comprises two or more projects. Groups are useful when you 

want to perform the same process (e.g. backup, consistency check) on 
a number of projects without having to launch the task for each single 
project. To create a group, right-click in the tree area view on the left 
and select New > Project Group. 

Scheduled Backups Backup schedules can now be configured for Backup project groups in 

the Administration client 



Central License 
Server (CLS) 



Scheduled Consis 
tency Checks 



Consistency checks schedules can now be configured for Consistency 
check project groups Administration client. 
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Low License Count 
Warning 

Search User 

Create Project 



A Service Health Monitor license warning was added. Low License 
count can be displayed in the Service Health Monitor. The threshold of 
the warning can be configured in the Administration client. 

The Search user feature now supports searching for substrings and the 
display of all matching users. 

Until now there was no edit control for the selection of the database & 
asset paths in the Administration Client. The Browse dialog was used 
instead, but proved not too practical for the selection of hidden shares. 
If the Custom locations option is selected, you can now edit the path 
directly in the field. Upon clicking Apply, an error message will be 
triggered if the location seized does not exist. 



Changes and Enhancements for the Windows Client 
Enhancements/ I mprovements 



Remote Client and 
Client Cache 



I mmediate Split 



Make Writable 



Change Sets 
Behaviour 



The Remote Client is a lean subset of your full-featured client and 
designed to speed up operation via a remote or otherwise slow or 
insufficient client-server connection. The Remote Client can be 
activated or deactivated at any time (File > Slow Connection 
Mode). 

The Shared Client Cache is another means of facilitating remote 
access, particularly for a group of people sharing a pool of common 
files. Frequently used data can be kept in the cache, thus reducing 
traffic between remote and local sites. 
(User Guide) 

The Branch creation now contains a new option, allowing users to 
specify whether they wish to have: 

1. Items in the new branch sharing properties (meta data) with their 
parent items (those in the parent branch) until a new version of the 
item is created in one or the other branch. This was the default and 
unique behavior until now. 

Or: 

2. Items in the new branch being, at the time of the branch creation, 
meta data independent from their parents (they will not share the 
same properties). This is now the default behavior. 

"Make writable" is now multi-selection aware. Note that the entry is 
aways visible inside a project for multi-selections. The event script 
does not work recursive, though. 

I n pre-8 versions, when the Change Set feature was disabled, "I mport" 
was immediate (no check-in needed). Whith Change Sets enabled, 
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Working Path Warn- 
ing 

More Efficient File 
I mport 



there was no possibility to immediately import. Now a new option for 
the Import Command. 

To avoid working path confusions for multiple users/branches, a new 
warning alerts users if they set a working path that is already in use. 

Up to version 8 there was no faster way than a multi selection to 
import new files into an already imported folder. The context menu 
now features the Import command and can be used to import all new 
files recursively. 



Changes and Enhancements for the Cross Platform Client 
Supported Version Changes 

The Cross Platform Client no longer supports Microsoft Windows. It is 
available for Linux and Mac OS only. 



Changes and Enhancements to the Project Converter 

Please see the note under "Important Installation and Update Notes" 
on page 5. 



Changes and Enhancements for the Command Line Tool 

The Command Line Tool is unchanged from previous versions. 



Changes and Enhancements to the I ntegrations 
Supported I ntegration Changes 

The Microsoft Office integration is no longer supported. To open and 
edit an MS Office document, right-click the file name in the Alienbrain 
Client. 

Enhancements/ Improvements 

Visual Studio The Visual Studio integration does now perform "Checkout" in the past. 

.NET SDK Command In addition to the classes in NXN. Alienbrain. SDK the namespace 
Wrappers NXN. Alienbrain. SDK. Commands contains auto-generated wrappers for 

several Alienbrain commands. These command wrappers are derived 
from the Command class and expose the command input and output 
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parameters as properties. Also the commands response handlers 
Command. HideResponseDialog are exposed by a corresponding 
response class Checkl n. Response which can be accessed via the 
Answer property. 

Maya 8.5 supported The Alienbrain Integration for Maya 8.5 is part of Alienbrain version 

8.0. 



Known Issues in Version 8.0 
Administration Issues 



Administration Cli- 
ent > User Manage- 
ment > Disable Login 



Administration Cli- 
ent > Active Project> 
Lock Project 

Project Server may 
keep on loading 
I nternalData 



When this checkbox is ticked, the particular user cannot work on the 
specified project anymore. However, this feature works ONLY when the 
project in question resides on the server to which the Admin Client is 
currently connected to. Another restriction applies: Disable Login 
works only for projects residing on the CCS (Central Configuration 
Server). 

The easy way to exclude users from accessing certain projects is to set 
their UserRole = None. But take a note of their prior role, because 
when you want to reinstate access rights you 1 II have to go back to this 
information (particularly when Custom Rights had been assigned). 

Locking a project will remove all central configuration settings from 
this project. 



Moving the CCS from one to another server will cause the fomer CCS 
server to keep on loading I nternalData project even though it is not 
CCS anymore. 

Therefore, while running through the Administration Client panels, you 
may see I nternalData from project servers - please ignore this. 



Cross- Platform Client Issues 



Mac OS X Tiger/ Mac 
OS X Panther 



The new Mac client has been compiled on a Mac OS X Tiger using gcc 
4.0 compiler. 

Therefore, launching the client on Mac OS X Panther, which per default 
offers gcc 3.4 native libraries, might lead to problems. The solution is 
to install the latest gcc libraries. 



Bug Fixes & Resolved I ssues 

The following known issues have been resolved in Alienbrain 8.0: 
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Server/ Communication Bridges 



Fill Bucket 



Visual Studio 



Central Configura- 
tion Server 

Project Converter 



Fill Bucket failed completely when it could not bucket a particular file. 
This was corrected: Instead of failing completely, it will now skip the 
missing files and add them to the FailedFiles ParamOut command 

Binding of a Visual Studio project did not work when the project had 
been manually imported via the Advanced client. 

CCS user synchronisation could fail on specific user names because of 
a wrong RegularExpression. 

Since 7.5, the Project Converter used to report an „Unhandled 
consistency problem 7030" which actually did not indicate any 
particular problem. 



Clients/ I ntegration API / Client Customization 



Visual Studio 2005 



Using Alienbrain I ntegration for Visual Studio (7.5.x) with Visual Studio 
2005 and with Change Sets enabled, you may have run into a problem 
with structural changes (Rename or Delete). Although everything 
seems to work fine for the user who makes the changes, they were not 
visible for other users. 



Create Share 



Advanced Search 
Pane 



Properties Dialog 



Time Stamp 
Short File Names 



The Create Share command did retrieve the latest version of the item, 
but it did not update the version number in the local file info. Therefore 
the share item did show a version 7/4' or something alike. 
(UDEV00218304). 

The SignOff states from the last search were not stored correctly (after 
a Reset). 

If the Signoff Workflow is disabled, the Advanced Search Page 
containes a scripting error in AssignedUser.xml. 

The size calculation in the Properties dialog used 'signed long': This 
means that the largest size it could display correctly was about 2.1 GB. 
If it was larger than that, the value was interpreted as a negative 
value. If it was larger than ~4.2 GB, it did overflow the 32bit value and 
the value was then completely wrong. 

Time stamp of labels created were set to daylight saving time (off by 
one hour) (UDEV00218119). 

During I mport via the API short filenames (8.3 filenames) were not 
expanded and therefore the Alienbrain server treated this as a new 
folder. The local path parameter is now expanded to long path name. 
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GetLatest Fail GetLatest could fail silently if the structural change synchronization 

fails. From version 8.0 on, when GetLatest fails, it will be aborted and 
the user will be informed. 
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Upgrading Alienbrain to Version 8.0 

Upgrading from Any Version 
Get a New Key First 




I f you are upgrading to Alienbrain 8.0, you need to get a new 
key prior to installation. You cannot complete the upgrade 



installation without an updated license key. Please e-mail the 
Hardware I D displayed in the Licenses view of the Administration Client 
to licensing@alienbrain.com and specify what type/how many licenses 
you need. The old client names are mapped to new clients as follows: 

• Manager Client > Advanced Client 

• Designer Client > Essentials for Artists 

• Developer Client > Essentials for Programmers 

The key will be provided by support in the form of a registration file 
(*.nxn). 

License Key Meanings: 

KEY-R: Reader 

KEY-C: Essentials for Programmers (incl. Araxis Merge) 

KEY- El : Essentials for Artists 

KEY- El A: Essentials for Artists (incl. Araxis Merge) 

KEY- 1 : Advanced Client 

KEY- 1 A: Advanced Client (incl. Araxis Merge) 

KEY-L: Advanced Cross- Platform for Linux Client 

KEY-M: Advanced Cross- Platform for Mac OS Client 

KEY-E: Advanced Cross- Platform for Windows Client 

KEY-X: Cross- platform Client (If a client uses Key-M or Key-L, the 

server will first consult its M and L pools respectively, and only if there 

are no available M or L licenses will consult the X pool.) 

When you start your installation, the following screen will appear, in 
which you must enter a valid license key for Alienbrain 8.0. 
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."= Alienbrain 



Enter Alienbrain License Key 



You are upgrading to Alienbrain. The license key mechanism has been changed and requires that you provide a new license 
key specifically generated for Alienbrain. License keys from previous versions will not work. 



Enter the location of your Alienbrain key here and then click Next> to proceed with the installation. 
| C:\License.nxn 



If you do not have an updated license key yet, the installation cannot be completed at this point. Please follow these steps to request an 
updated license key: 



1.) The following license key is currently installed: 
License Information: 



Hardware ID: 
License Type: 



| CB KL-M KKN -CG I G -H D AA-N B G I -J □ L-H M M C-J KO P-KD M -FAG G-KDNE -PB LG -B J LL-KCPG -HAN □ -E 
| PERMANENT 



2. ) Send an e-mail to licensing@alienbrain.com with the complete license key information above and the 

name and address of your company. Make sure that you use a valid e-mail address. 

3. ) An updated license key based on your current license configuration will be sent to you. 

4. ) Exit the installation now and start it again once you receive a key for Alienbrain. 

Alienbrain - 



1 



Figure 1: Enter 8.0 Key 



Refer to the relevant instructions to follow for your upgrade before pro- 
ceeding with the installation. See also: "Upgrading from Version 7.x" 
and "Upgrading from Version 6.x". 



Split Your Databases from Your Assets 



Starting in version 7.1.1, splitting the project data (assets) from 
project database (metadata) has been possible. Since 7.5, it is possi- 
ble to split the database for new projects using settings in the Adminis- 
tration Client. It is also possible, and recommended, to manually split 
the database for existing projects. After following any relevant upgrade 
instructions that follow, see the document entitled "Recommendation 
for Database Storage" in the Administration Guide for instructions. 

The Alienbrain Version 8 Server setup routine offers the splitting as a 
an option. 
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Upgrading from Version 7.x 
Get a New Key First 




I f you are upgrading to Alienbrain 8.0, you need to get a new 
key prior to installation. You cannot complete the upgrade 



installation without an updated license key. Please e-mail the 
Hardware I D displayed in the Licenses view of the Administration Client 
to licensing@alienbrain.com and specify what type/how many licenses 
you need. The old client names are mapped to new clients as follows: 

• Manager Client > Advanced Client 

• Designer Client > Essentials for Artists 

• Developer Client > Essentials for Programmers 

The key will be provided by support in the form of a registration file 
(*.nxn). Then you can then skip directly to the server installation 
chapter in the Installation Guide. No project conversion is required for 
an upgrade from version 7.x to 8.0. 



License Key Meanings: 

KEY-R: Reader 

KEY-C: Essentials for Programmers (incl. Araxis Merge) 

KEY- El : Essentials for Artists 

KEY- El A: Essentials for Artists (incl. Araxis Merge) 

KEY- 1 : Advanced Client 

KEY- 1 A: Advanced Client (incl. Araxis Merge) 

KEY-L: Advanced Cross- Platform for Linux Client 

KEY-M: Advanced Cross- Platform for Mac OS Client 

KEY-E: Advanced Cross- Platform for Windows Client 

KEY-X: Cross- platform Client (If a client uses Key-M or Key-L, the 

server will first consult its M and L pools respectively, and only if there 

are no available M or L licenses will consult the X pool.) 

The alienbrain.xml file which configures the preview server is 
overwritten at the time of upgrade because of significant changes to 
the preview server. The old file is backed up to alienbrain.xml BAK 

Please compare the two files and merge any necessary changes into 
the new alienbrain.xml file. In the new file, the 
ServerEnableDiskGuard setting is now "no" and the 
ServerCacheDiskTimeout setting is "200days". Previously only files 
older than 10 years were deleted, and in the new version, deleting old 
files is disabled (if enabled, the default is 200 days). Files are only 
deleted when disk space runs out (this is unchanged). Additionally the 
current file now has defaults of: 

ServerCacheMemoryTimeout="2hours" (previously 12 hours) 
ServerCacheGuardRescanDelay="lhours" (previously 1 day) 
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Upgrading from Version 6.x 

Because many significant changes have been made to the Alienbrain 
client and server for version 7 and later, it is imperative that you 
read this document so that the transition is as smooth as possible 
and you know what to expect from the new system. You will be 
informed of tests you should perform, files to check, settings to 
change, and any other adjustments necessary to ensure the correct 
results. 

Please follow each step as outlined in this document for a successful 
upgrade. Feel free to contact Alienbrain at any time with questions or 
concerns. 

Before You Start 




I f you are upgrading to Alienbrain 8.0, you need to get a new 
key prior to installation. You cannot complete the upgrade 



installation without an updated license key. Please e-mail the 
Hardware I D displayed in the Licenses view of the Administration Client 
to licensing@alienbrain.com and specify what type/how many licenses 
you need. The old client names are mapped to new clients as follows: 

• Manager Client > Advanced Client 

• Designer Client > Essentials for Artists 

• Developer Client > Essentials for Programmers 

The key will be provided by support in the form of a registration file 
(*.nxn). 

License Key Meanings: 

KEY-R: Reader 

KEY-C: Essentials for Programmers (incl. Araxis Merge) 

KEY- El : Essentials for Artists 

KEY-EIA: Essentials for Artists (incl. Araxis Merge) 

KEY- 1: Advanced Client 

KEY- 1 A: Advanced Client (incl. Araxis Merge) 

KEY-L: Advanced Cross- Platform for Linux Client 

KEY-M: Advanced Cross- Platform for Mac OS Client 

KEY-E: Advanced Cross- Platform for Windows Client 

KEY-X: Cross- platform Client (If a client uses Key-M or Key-L, the 

server will first consult its M and L pools respectively, and only if there 

are no available M or L licenses will consult the X pool.) 
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Time and Space Requirements 

Be aware that projects prior to version 7 must be converted to 
accommodate a new server structure, and this is a time and space 
consuming process. Allow at least 2-3 days for the upgrade 
process during which users will not have access to the project. 

The project converter installs part of the old server to load the old 
database, converts it to the new structure and creates the new 
projects. This requires more RAM than the old server to execute the 
task. Space requirements depend on the project size and machine 
specifications, but you should have at least 2 times the amount of 
harddisk space as your .vcp and .pro files combined. 




Documentation about the project converter and the conversion is 
installed with the project converter. 



Large projects should be converted with the support of Alienbrain. The 
upper limit of project size that can be converted has not yet been 
determined. 

Note Regarding With version 7, the Alienbrain server and the project converter (for 

Large Projects upgrades) are able to use up to 3 GB RAM. Earlier versions of Alien- 

brain only supported 2 GB of RAM. 

In order to get up to 3 GB from the operating system, the hardware 
and the OS need to support this. 

1. You need 4 GB of RAM (because Windows needs RAM as well, 3 GB 
are a good starting point). 

2. You need an operating system that supports this 3 GB per process 
option: Windows 2000 / XP / 2003 

3. You must set a switch for the OS in order to support this. Usually it 
is add "/3GB" to the line in the boot .ini, e.g. 

mult i (0) disk (0) rdisk (0) partition (1) \WINDOWS= "Microsoft 
Windows 2003 Enterprise" /fastdetect 

to 

multi (0) disk (0) rdisk ( ) partition ( 1 ) \WINDOWS= "Microsoft 
Windows 2003 Enterprise" /fastdetect /3GB 

Please see the article "A Description of the 4 GB RAM Tuning Feature 

and the Physical Address Extension Switch" 

( http://support.rn icrosoft.com/default.aspx?kbid =29 1988) 

for an explanation of the different OS behaviors with the /3GB and / 

PAE switches. 



www.alienbrain.com 



Time and Space Requirements • 19 



Upgrading from Version 6.x 



Changes You Need to Know About Starting in Version 8 

This document provides just a brief overview of the new features. For 
details please refer to the section „What's new in Alienbrain 8.0" in the 
User's Guide and to the Release Notes. 



1. The Alienbrain database must reside on the Alienbrain server 
machine. The server will not load remote databases anymore. 
(This behaviour was already introduced with version 7.5.2) 

2. Branch specific Bucket management allows you to selectively 
move older versions into special folders called buckets, now even 
with regard to certain branches. 

New Tools for To assist you in installing and administrating this new system, the 

Administrators following tools have been implemented: 

1. Project Grouping - it is now possible to put two or more projects 
together (= grouping) and schedule specific processes (such as 
database backup) for all projects contained in the group. 

2. Enhanced centralized administration - With version 8, 
capabilities such as license management and database backup 
have been added to the centralized administration features. 

3. A consistency checker in the Administration Client for verifying 
project files. 



Relevant Server 
Changes 
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Project Converter Codes and Messages 

The following list details messages that may be reported in the Project 
Converter log, and which actions you should take. 

Serious Errors: Codes < 100 



Code Number 


Explanation 


Recommendation 


1 


The converter nrorlurerl an nhiect 

II Id LUI 1 VCI LC Ul UUULCU CI 1 1 UUJ CLL 

without a server file. 


Dn not use this nroiert 

1— ' w 1 IUL UDC L 1 1 1 D |JI \Jj C: V_ L . 


2 


Thp rnnvprtpr failprl to rrpatp an nhiprt 

IMC L.UI IVCI LCI lull CU LKJ LI CCILC Oil KJ kJJ CL L. 


Do not use this nroiert 

1 / w 1 IUL U LI 113 kJ 1 WJ CLL. 


3 


The converter calculated the wrong par- 
ent for an object. 


Convert again without activity history 
(na). 


4 


The converter could not create a new 
project. 


Check if a server is running with this 
project activated. Deactivate project 
and try again. 


5 


The converter miscalculated the inherit- 
ance relations of an object, i.e. this 
object is not in one of the branches 
anymore. 


Do not use this project. 


6 


The converter placed a older version as 
latest in a branch. 


Do not use this project. 


7 


The target server is too old. 


Do not use this project, get a newer 
Alienbrain server (>= 7.0.2) 
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Warnings: 100 <= Codes < 1000 



Code Number 


Explanation 


Recommendation 


100 


The consistency checker found a prob- 
lem unhandled by the project converter. 
This is either: 

* a problem already in the original 
project, unfixed by the converter 

* a completely new test of the consis- 
tency checker 


Use converted project, if it was OK 
before, it is now too. 

Check the log file, converted project 
probably ok. 


101 


Folder share was pointing to the future: 
corrected. 


Project is fine. 


102 


Two versions of the same object had 
the same time: corrected. 


Project is fine. 


103 


An object was created before its par- 
ents (say the time stamp). This was 
probably corrected by the project con- 
verter. 


Check the log. 


104 


Two versions of the same object have 
reverse order time stamps: corrected. 


Project is fine. 


105 


An object was split but not changed 
(undo checkout). Custom properties on 
split are lost. 


Project is fine. 


106 


An object was split but not changed 
(undo checkout). Custom properties on 
split are lost. 


Project is fine. 


107 


An object was split and structurally 
changed (in one branch) but the time 
stamp was not showing this object time 
adopted. 


Project is fine. 


108 


A master object had no parent at the 
correct time and could not be moved to 
a better place. Version lost. The server 
file is still there, but Alienbrain does not 
show this. 


Manually import (check in) this version. 
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109 


A version object had no parent at the 
correct time and could not be moved to 
a better place. Version Lost. The server 
file is still there but Alienbrain does not 
show this. 


Check file to see if you need it. 


110 


Internal correction. 


Project is fine. 


111 


A dependency has no source: depen- 
dency removed (object was deleted in 
version 6, but not the dependency). 


Project is fine. 


112 


Due to timing issues, two objects tried 
to get the same name at the same 
time. The second object was renamed. 


Check log whether rename is still in lat- 
est. 


113 


The converter found an object without a 
name, i.e. corrupted object. Object 
removed. 


Project is fine. 


114 


The converter found an object without a 
BIH, i.e. corrupted object. Object 
removed. 


Project is fine. 


115 


The consistency checker found a prob- 
lem in the converted project that was 
inherited from the old version. 


Check if this is a problem; the con- 
verted project is no worse than the 
original. 


116 


A deleted file has no server file. 


Project is OK. 


117 


A problem with dependencies could not 
be fixed. 


Check if this is a problem; the con- 
verted project is no worse than the 
original. 


118 


A bidirectional dependency is broken: 
removed. 


Project is fine. 


119 


A deleted item can not be undeleted. 


Check it if it is an important item that 
the server file is there. 


120 


A bucketed object misses its server file 
(in the original project). 


Project is fine. 


121 


A version in the original project was 
corrupted: removed. 


Project is fine. 


122 


Object was checked out: checkout state 
removed. 


Project is fine. 


123 


Object was locked: lock state removed. 


Project is fine. 


124 


Found a working path reference to a 
non-existent object: removed. 


Project is fine. 
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125 


The consistency checker threw an 
exception, not the converter. 


Project is fine. 


126 


Internal message. 


Project is fine. 


127 


1 nternal message, 


Project is fine. 


128 


Project is hybrid: fixedserverpath + 
buckets. This makes conversion diffi- 
cult. Activity history switched off. 


Project is fine. 


129 


Object had an invalid time stamp. Set 
to something sensible. 


Project is fine. 


130 


Internal message. 


Project is fine. 


131 


Internal message. 


Project is fine. 


132 


A share (server link) was broken in all 
branches: removed. 


Project is fine. 


133 


A share (server link) was broken in one 
branch. 


Project is fine. 


134 


Found a latest version without server 
file (in original project). 


Project is fine, but check object. 


135 


Cannot create object because parent 
does not (yet) exist. Try to adjust time. 


Check log whether adjustment worked 
(search for [error]). 


136 


Time adjustment failed because moving 
an object before its branch has strange 
side effects. Version lost. 


Project otherwise fine. 


137 


Structural change information before 
object existed, information dropped 
(latest is fine). 


Project is fine. 


138 


Object had an invalid name, name 
adjusted. 


Project is fine. 


139 


The file Alias. xml could not be found. 
Some checks are not possible. 


Project is fine. 


140 


The original project had a loop in its 
parent child structure. Loop removed. 


Project is fine. 


141 


The original project had a folder share 
into the future which is not a bug in 
Alienbrain 6, but impossible in 7. 
Attempting to correct this. 


Check log. 
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142 


The converter is older than your server. 
The conversion might be OK, but it is 
better to use a newer converter. 


Get a newer project converter. 


143 


Converter and target server have differ- 
ent version numbers. If you are not 
using a patch on the server or converter 
on purpose, consider using the con- 
verter from the current server. 


Get the converter from the server 
upgrade. 


Information Messages: Codes >= 1000 


Code Number 


Explanation 


Recommendation 


1000 


Master was not the latest, corrected. 


Project is fine. 


1001 


Object destroyed to match original 


Project is fine. 


1002 


1 nternal 


Project is fine. 


1003 


Object time adjusted. 


Project is fine. 


1004 


Object information completed. 


Project is fine. 


1005 


Object was renamed to avoid a merge 
conflict. Rename it back to its correct 
name affects latest only. 


Project is fine. 
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